home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / gfx / conv / PicConvert.lha / picconvert / docs / ilbmtoppm.man < prev    next >
Text File  |  1995-01-24  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ilbmtoppm - convert an IFF-ILBM, IFF-RGBN or IFF-RGB8 file
  10.           into a portable pixmap
  11.  
  12.      SYNOPSIS
  13.           ilbmtoppm [-verbose] [-ignore chunkID]
  14.           [-isham|-isehb|-isdeep [-cmaponly] [-adjustcolors]
  15.           [-transparent color] [-maskfile filename] [ILBMfile]
  16.  
  17.  
  18.      DESCRIPTION
  19.           Reads an IFF-ILBM, IFF-RGBN or IFF-RGB8 file as input.
  20.           Produces a portable pixmap as output.  Supported ILBM types
  21.           are:
  22.  
  23.           Normal ILBMs
  24.                1-8 planes with or without colormap, or 9-16 planes
  25.                with colormap.  If no colormap is present, interprets
  26.                the pixel values as intensity (grayscale) values.
  27.                Amiga display modes Extra_Halfbrite (EHB) and Hold-
  28.                and-modify (HAM) are supported, and the multiplatte
  29.                formats Palette Change (PCHG chunk), Dynamic HAM/Hires
  30.                (CTBL chunk) and Sliced HAM (SHAM chunk).  HAM images
  31.                are limited to 3-10 planes.
  32.  
  33.           Deep ILBMs
  34.                9, 12 or 15 planes without colormap, or 18-48 planes
  35.                (the number of planes must be divisible by 3).  Most
  36.                deep ILBMs have 24 planes (for 8-bit RGB values).
  37.  
  38.           Colormap files
  39.                BMHD + CMAP chunk only, 0 planes.
  40.  
  41.           Chunks used:
  42.                BMHD, CMAP, CMYK, CLUT, CAMG, PCHG, CTBL, SHAM, BODY
  43.  
  44.           Chunks ignored:
  45.                GRAB, DEST, SPRT, CRNG, CCRT, DYCP, DPPV, DRNG, EPSF,
  46.                JUNK, CNAM, PRVW
  47.  
  48.           Other chunks (ignored but displayed in verbose mode):
  49.                ANNO, AUTH, (c), DPI, FVER, NAME, TEXT
  50.  
  51.           Unknown chunks are skipped.
  52.  
  53.      OPTIONS
  54.           Options marked with (*) can be prefixed with a "no", e.g.
  55.           '-noverbose'.  All options can be abbreviated to their
  56.           shortest unique prefix.
  57.  
  58.  
  59.           -verbose (*)
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 1/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  71.  
  72.  
  73.  
  74.                Give some information about the input file.
  75.  
  76.  
  77.           -ignore chunkID
  78.                Skip a chunk.  chunkID is the 4-letter IFF chunk
  79.                identifier of the chunk to be skipped.  This option can
  80.                appear more than once on the command line.
  81.  
  82.  
  83.           -isham | -isehb
  84.                Treat the input file as a HAM or EHB picture, even if
  85.                these flags or not set in the CAMG chunk (or if there
  86.                is no CAMG chunk).  This option has no effect with RGBN
  87.                and RGB8 pictures.
  88.  
  89.  
  90.           -isnotham | -isnotehb
  91.                Do not treat the input file as a HAM or EHB picture,
  92.                even if these flags are set in the CAMG chunk.  This
  93.                option has no effect with RGBN and RGB8 pictures.
  94.  
  95.  
  96.           -isdeep
  97.                Treat an input file with less than 16 planes as a deep
  98.                ILBM, even if it provides a colormap. The number of
  99.                planes in the input file must be divisible by 3.  This
  100.                option has no effect with RGBN and RGB8 pictures.
  101.  
  102.  
  103.           -isnotdeep
  104.                Do not treat an input file as a deep ILBM, even if it
  105.                has more than 8 planes and/or no colormap.  This option
  106.                has no effect with RGBN and RGB8 pictures.
  107.  
  108.  
  109.           -adjustcolors (*)
  110.                Scale a 4-bit colormap or shifted 4-bit colormap to 8
  111.                bits.  If this option is not used and believes that the
  112.                colormap consists of 4-bit values or shifted 4-bit
  113.                values, it prints a warning.  This option has no effect
  114.                with RGBN and RGB8 pictures.
  115.  
  116.  
  117.           -cmaponly
  118.                Extract only the colormap from the input file.  The
  119.                resulting PPM file will be in P3 ASCII format.  This
  120.                option results in an error if used with a RGBN or RGB8
  121.                file.
  122.  
  123.  
  124.           -transparent color
  125.                Write transparent pixels in color instead of their
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 1/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ilbmtoppm(1)         AMIGA (25 October 1994)         ilbmtoppm(1)
  137.  
  138.  
  139.  
  140.                colormap entry. The color is specified as in
  141.                ppmmake(1).
  142.  
  143.  
  144.           -maskfile filename
  145.                Generate a mask file from a mask plane or transparent
  146.                color entry (ILBM), or genlock bits (RGBN/RGB8) and
  147.                write it to filename. This is a normal PBM image, the
  148.                same size as the PPM output file.  A pixel value of
  149.                PBM_WHITE in the mask file means the corresponding in
  150.                the output file is considered to be transparent,
  151.                PBM_BLACK indicates an opaque pixel (think of the
  152.                output file casting a shadow on a white screen).
  153.  
  154.  
  155.      BUGS
  156.           Lasso masks are not supported.  CLUT and CMYK chunk code is
  157.           untested.
  158.  
  159.  
  160.      REFERENCES
  161.           Amiga ROM Kernel Reference Manual - Devices (3rd Ed.),
  162.           Addison Wesley, ISBN 0-201-56775-X, Appendix A: Interchange
  163.           File Format
  164.  
  165.  
  166.      SEE ALSO
  167.           ppm(5), ppmtoilbm(1)
  168.  
  169.  
  170.      AUTHORS
  171.           Copyright (C) 1989 by Jef Poskanzer.
  172.           Modified 1993/1994 by Ingo Wilken
  173.           (Ingo.Wilken@informatik.uni-oldenburg.de)
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 1/23/95)
  196.  
  197.  
  198.  
  199.